home *** CD-ROM | disk | FTP | other *** search
/ Acorn RISC PD-CD 1 / Acorn RISC PD-CD 1.iso / utilities / _printapps / printapps / _textmax / _help next >
Encoding:
Text File  |  1993-09-20  |  18.2 KB  |  335 lines

  1.                               !TextMax 
  2.                      - The Text printer Maximiser
  3.                      (For Epson compatible printers)
  4.  
  5.       This is a utility to allow you to use italics ,bold print,
  6. superscript, etc. in text files by effectively offering these facilities in
  7. embedded command form (Like for changing font,colour,etc.). I wrote it
  8. because I can't stand First Word Plus,and would rather use !Edit.The problem
  9. is that you can't type in escape characters to !Edit,so it's impossible to
  10. type in codes for superscript,bold,italic,etc.I couldn't stick this,as I
  11. have a superscript in my name( The c in "McEwan"),and it's really sickening
  12. to have to send letters to people with your own name done wrongly,'cos then
  13. you can't get at people for not writing your name properly!.I designed this
  14. with my Star LC-200 colour dot-matrix in mind..
  15.  It supports the standard FX commands,but I'm not sure if it will work with
  16. any other printers.It should though.The embedded commands are these.
  17.  
  18.     Standard commands (Provided by printer);
  19.  
  20.  ((0))     Select manual paper feeding.
  21.  ((4))     Select automatic paper feeding.
  22.  ((C))n    Change to colour n - for colour printers.
  23.               "n" is a 3 bit binary number whose bits have the following 
  24.            meanings:              Bit 0 - Use the red ribbon.
  25.                                   Bit 1 - use the blue ribbon.
  26.                                   Bit 2 - Use the yellow ribbon.
  27.            So,to print in blue,you would type in your doccument "((C))2".
  28.            More than one ribbon may be used (in which case the print-head
  29.            passes over twice or more.). It is not possible to use all 3
  30.            ribbons "((C))7",and if no bits are set "((C))0" the black ribbon
  31.            will be used.NB the actual entered number MUST be entered in
  32.            DECIMAL.
  33.  ((F))n    Change to font number n.The font numbers are standardised,but not
  34.            all printers have all fonts.The ones I know,because my printer
  35.            has them are :0 Courier,1 SansSerif,4 Script,7 Orator,9 Draft. Or
  36.            at least I think they are standardised. Look in your printer
  37.            manual for the codes and fonts your printer supports.
  38.  ((R))     Eject paper from Automatic Sheet feeder.
  39.  ((S))n    Selects a print size."n" is a 2-bit binary number whose bits have
  40.            the following meanings:
  41.                                   Bit 0 - width  (0 normal,1 double)
  42.                                   Bit 1 - height (0 normal,1 double)
  43.            So the command "((S))3" would select double height,double width,
  44.            and the command "((S))0" would return to normal.NB the actual
  45.            number entered MUST BE IN DECIMAL.
  46.  ((T))n    Set starting point on paper from automatic sheet feeder n/6
  47.            inches from the top of the paper,so "((T))6" would start printing
  48.            one inch from the start of the page.
  49.  
  50.   NB commands ((0)),((4)),((R)) and ((T))n are only recognised by the
  51. printer if it has a cut-sheet feeder installed (mine doesn't),and the ((C))
  52. command will only be used if you have a Colour-compatible printer (like
  53. mine!).If the printer doesn't want to use a command (above),it will print
  54. the command instead,so be warned - if you type it in wrong,then you'll get
  55. the command on your printed page.
  56.  
  57.     The commands provided by this utility are of the form [[x]],so that
  58. there is no confusion with possible future epson codes;
  59.  
  60.  [[^]]     Superscript.Causes subsequent characters to be printed
  61.            superscript (If your really that thick that you don't know what
  62.            that means,then try it out and see what it looks like.)
  63.  [[6]]     Subscript.You know what that means.I chose six because it's on
  64.            the same key as the up arrow thingie,which is the best mnemonic I
  65.            could find for it.
  66.  [[¾]]     Cancel super/subscript.You obtain this character by pressing the 
  67.            6/^ key while holding down Alt.
  68.  [[/]]     Italic printing.
  69.  [[|]]     Upright printing.
  70.  [[D]]     Double-strike printing (Bold).
  71.  [[d]]     Cancel double-strike.
  72.  [[E]]     Emphasized printing (Another form of bold).
  73.  [[e]]     Cancel emphasized printing.
  74.  [[_]]     Underlining on.
  75.  [[+]]     Underlining off.
  76.  
  77.  Embedded commands are strings of text which may be placed in a document to
  78. be printed. When the printer recieves one of these commands,instead of
  79. printing it,it will use it to change font,size,colour,etc. For example:
  80.  
  81.    To print my name properly,I'd put in my document the following:
  82.  "Hello there,my name is Colin M[[^]]c[[¾]]Ewan."
  83.    To emphasise a word by using a different colour (if you have a colour
  84. printer),use the following in your document:
  85.  "But this application is ((C))1really((C))0 odd,as it does stupid things."
  86.  
  87. The Application
  88. ¨¨¨ ¨¨¨¨¨¨¨¨¨¨¨
  89. To load:
  90.         Double-click on the icon in the directory viewer.
  91. To use:
  92.         Drag a Text-file to the iconbar icon. It will be printed.
  93.  
  94. The Options Window
  95. ¨¨¨ ¨¨¨¨¨¨¨ ¨¨¨¨¨¨
  96.  
  97.   By Clicking SELECT on the iconbar icon,the options window will be
  98. displayed. At the right of this window are 3 icons toward the bottom. They
  99. are:
  100. Set-up :If you click this,then the printer will be set to the current
  101.         settings (see below).This is not neccesary before printing a
  102.         document.
  103. Save   :Clicking this will cuase the current settings (see below) to disc,so
  104.         that those settings are used automatically when you next load
  105.         TextMax.
  106. OK     :This closes the window and takes a note of the settings.
  107.  
  108.   To the left of these icons,is an area which controls the settings. This
  109. may be scrolled by using the scroll bar to it's right. It contains the
  110. following:
  111.  
  112.  Miscelaneous...
  113.         Formfeed       -if this is selected,then at the end of a
  114.                         document,the paper will be moved up to the top of
  115.                         the next page.
  116.         Letterhead     -If this is selected,then the file "Letterhead" will
  117.                         be printd befor the text.See below.
  118.         Multitasking   -This option is not yet implemented.When it is,it
  119.                         will allow multi-tasking to continue in the desktop
  120.                         whilst printing is taking place.
  121.  Text Justification...
  122.         Left Justify   -If this is selected,then text will be aligned to the
  123.                         left margin, leaving gaps at the right margin.
  124.         Centre of Page -If this is selected,then text will be centred
  125.                         between the left and right margins.
  126.         Right Justify  -If this is selected,then text will be aligned to the
  127.                         right margin,leaving gaps at the left margin.
  128.         Full (double)  -If this is selected,then extra spaces will be
  129.                         inserted in the text,to enable text to be aligned to
  130.                         both left and right margins,giving straight edges at
  131.                         both left and right margins.
  132.                 NB if you select a different character pitch,then you will
  133.                 have to alter the right-hand margin (see below).
  134.  Pitch...
  135.         Pica  (10 CPI) -This will cause text to be printed at a pitch of 10
  136.                         Columns per inch,giving 80 columns on a standard A4
  137.                         sheet of paper.
  138.         Elite (12 CPI) -This will cause text te be printed at a pitch of 12
  139.                         Columns per inch,giving 96 columns on a standard A4
  140.                         sheet of paper.
  141.         Condensed      -If this option is selected,then text will be printed
  142.                         condensed,so allowing more columns on a piece of
  143.                         paper.Pica will be condensed to 17.1 CPI and Elite
  144.                         will be condensed to 20 CPI,giving 137 and 160
  145.                         columns on a sheet of paper respectively.NB
  146.                         Condensed print may not be printed in NLQ.
  147. Font...
  148.         Here is shown the currently selected printer font. By clicking on
  149.         the arrow to the right of this box,a menu may be called up,from
  150.         where may be selected a different font to be used. The font numbers
  151.         are standardised,but only the fonts for my printer are currently
  152.         listed.If you know of other fonts,please tell me their names and
  153.         font numbers so I may include them on the menu in future versions.
  154.         NB - If your printer doesn't have any of these fonts,then select a
  155.         font from you printer's control panel,and that font will be used
  156.         instead.
  157. Margins...
  158.         Left           -This is the number of characters from the left hand
  159.                         edge of the paper the printing will start at.
  160.         Right          -This is the number of characters from the left-hand
  161.                         edge of the paper printing will stop.NB If you
  162.                         select a different pithc,you will have to expand the
  163.                         right margin from the default 80.
  164. Print Direction...
  165.         Uni-directional-This causes the text to be printed
  166.                         uni-directionally.This takes longer than
  167.                         bi-directional printing,and is supposed to give
  168.                         better quality print,due to more accurate dot
  169.                         alignment,but on my printer,it just seems to make
  170.                         the dots align all wrong.
  171.         Bi-directional -Bi-directional printing is faster than
  172.                         uni-directional,and is supposed to give slightly
  173.                         worse results,but my printer works better with
  174.                         bi-directional.Try both to see which works best on
  175.                         your printer.
  176. Colour...
  177.         If you have a clolour printer,then you may select the default colour
  178.         of the text from this menu (use it like the Font menu above).Not
  179.         really useful,but included for completeness.
  180.  
  181.  
  182. The Letterhead Option.
  183. ¨¨¨ ¨¨¨¨¨¨¨¨¨¨ ¨¨¨¨¨¨¨
  184.         This option causes a letterhead to be printed before the text-file.
  185. To create a letterhead,follow the instructions below:
  186.         1)      Load up !Draw (or !Paint,or ANYTHING else which uses the
  187.                 RISC OS printer driver) and design your letterhead.
  188.         2)      Load your printer driver and set it to print to the file
  189.                 "Letterhead" in this application directory.
  190.         3)      Print your letterhead.
  191.         4)      Set your printer-driver to print to your printer again.(This
  192.                 is to ensure the printout file is complete and closed)
  193.         5)      To print a letterhead before a letter,select the
  194.                 "Letterhead" option from the TextMax options window,and
  195.                 print the letter by dragging it down to the TextMax icon.The
  196.                 text will be printed from the bottom of the letterhead,so
  197.                 you just need to start your letter "Dear Sir/Madam/Bogey,".
  198.  
  199. A letterhead file is inclded in the directory already,but there are 3 things
  200. about it which will discourage you from using it:
  201.         1)      It is horrible draft quality.
  202.         2)      It is my letterhead with my address on it.
  203.         3)      It will only work with an FX-Compatible printer.
  204.  
  205. *****************************************************************************
  206.  
  207.         This application may be freely copied,used and distributed,so long
  208. as no profit,of more than 25% of the charge made,may be made by copying it.
  209. All files must be left intact and unchanged,and no alterations may be made
  210. without prior permission of the author (me).
  211.  
  212. *****************************************************************************
  213.  
  214.  
  215.         If anyone out ther has a Public Domain Download font editor,or has
  216. fonts suitble for direct download to printer,then I'd welcome these very
  217. much (I get bored with Courier,Sansserif,Script,Orator,and especially
  218. Draft,although the 225 CPS megadraft mode is FAST,and highly useful for
  219. printing out long documents,like this or the user manual for WimpExtension.
  220.  
  221.         Thanks to Jon Ribbens for the WimpExtension module,which is
  222. excellent,but has a very long manual .Also thanks to whichever supplier it
  223. was I got my LC200 from.Thanks to Acorn for writting the RO3 PRMs,and not to
  224. the Computer Depot for not stocking them,thus making me have to wait 'till 2
  225. weeks from now 'till I can get my mitts on them...
  226.  
  227.         Anyway,I suppose I'd better go and do something useful,like work on
  228. BackDrips v1.06H. Just like v1.06,except it's designed to work from a
  229. hard-disc,rather than the ResourceFS.Therefore,it will have the advantage of
  230. taking less memory,but the disadvantage of loading slightly slower (I can't
  231. test this,as I don't have a Hard-Disc).Oh yeah,the address...
  232.  
  233.         I may be contacted at this address:
  234.  
  235.                                 Colin McEwan
  236.                                 11 Helen Way
  237.                                 Bonhill
  238.                                 Dunbartonshire
  239.                                 Strathclyde
  240.                                 Scotland
  241.                                 G83 9PJ
  242.  
  243.         Also welcome at the above address are:
  244.                 Letters, Download fonts, Details of other standard printer
  245. fonts, PD software, videos of [ Blossom, Roseanne, Cheers, Drop the Dead
  246. Donkey, Whose Line Is It Anyway?, Absolutely, etc.], ZX9 and ZX9CL printer
  247. ribbons (new ones,not old ones!), money (!!?!??), hard-disc drives, A5000s,
  248. scanners, digitisers, Laser printers, Multi-sync monitors (Yup,I've still
  249. got a TV-res monitor...), digitised pictures [see above list of TV progs],
  250. tapes of [anything really. I'm one of those odd peoples who can listen to
  251. anything. I am currently listening to the Shamen's "Boss Drum" on Atlantic
  252. 252,but I also love classical, folk, "Sixties",and just about everything
  253. else.], paper-clips, letters, upgrades from Oak-Recorder to Oak-Recorder II,
  254. E-format floppy discs (NOT F-format,as I've only got an 800k disc drive),
  255. cheap-nasty things from Corn-flake packets, and anything else really.
  256.  
  257.         If you click on my name in the info window,you will find a nice
  258. scrolly window. I got this idea from Clarisworks on my school's apple-macs
  259. (YEUCH!),but the only purpose I can see in Apple-Macs is that they are there
  260. to have ideas nicked from them. Now there's the thing about the
  261. apple-macs.They try to be too cute.But it's an odd sort of cute. Not cute
  262. like the Archie's little cartoony icons,but having cute (or rather stupid)
  263. options for silly noises and things. Is that a waste or what? The difference
  264. between the Arc and the Mac is that on the mac you have to pay for the cute
  265. stuff (i.e. It is Apple themselves who are silly),but on the Arc,the silly
  266. stuff is completely free (i.e. it is people like wot I is who write the
  267. silly stuff.). Go suck an Apple-Mac (Sorry... I didn't mean that...)
  268.  
  269. Version History
  270. ¨¨¨¨¨¨¨ ¨¨¨¨¨¨¨
  271.         Righty-ho. Version history...(changes that is...)
  272.  
  273.         1.00 (01 Aug 1993)
  274.                 First half-decent version. All production variants were also
  275.         numbered 1.00, so this could get confusing if you have a pre-release
  276.         version (but I only gave this to a few friends, so I'll have words
  277.         with them if it ever got out into general circulation.)
  278.  
  279.  
  280.         1.01 (05 Aug 1993)
  281.                 Altered menu icons (gright) so they popped into the sprite
  282.         pgright. Much nicer.
  283.                 Made whichmenu% variable point to the location of the menu
  284.         structure, rather than just numbering the menus. This way, I can
  285.         identify the current menu, as well as examining it without the need
  286.         to use a CASE or anything.
  287.                 Corrected the positioning of the colours and fonts menus
  288.         relative to the gright button. I'd only ever previously encountered
  289.         this in !Configure, and I hadn't looked too closely at it.
  290.                 Removed outline fonts from Info window, too keep RO2ers
  291.         happy.
  292.                 Added beep when error or prompt.
  293.                 Removed "Okay then." report when cancelling unknown file
  294.         print. (this was stupid and pointless).
  295.                 Moved options to a menu option (rather than just clicking
  296.         iconbar).
  297.                 Removed Close icon from options window.
  298.                 Added option to change default slabbing colours. Can be grey
  299.         3 for compliance, or grey 1 or orange for good taste. You can even
  300.         have icons slabbing cream if you want. (Disgusting, but according to
  301.         Acorn,most people seem to like it...)
  302.                 Added option to turn menu icons on or off.
  303.                 Options dialogue box is now a true dialogue box in that
  304. nothing happens until you press OK (not true actually. It's just that if you
  305. press CANCEL it undoes it all. That's probably better,'cos then the user can
  306. see what he/she wants to do safely). Whoever it was that designed Morpheus
  307. ought to be taken out and publicly insulted for his/her options box. It's
  308. horrible, and does not in any way follow the RISC OS standards. And besides
  309. which, instead of OK or CANCEL, they put the word "Close" on the OK icon.
  310. Eurgh.
  311.                 Fixed slight (understatement...) bug with versions of
  312. WimpExt larger than 2.17. Gave silly errors because the command
  313. WimpExt_Defaults was changed to WimpExt Defaults. Highly annoying. I don't
  314. know exactly which version this was changed in, but I know it's somewhere
  315. between 2.10 and 2.17... I have assumed the transition took place with
  316. version 2.17. If you have a version between 2.10 and 2.17, (or even beter,
  317. if you know WHEN this change took place),then please write and tell me. I'm
  318. away to play Zool, or SWIV, or Xenon II or something now. ByeBye.
  319.  
  320.         1.02 (20 Sep 1993)
  321.                 What I said above about versions of WimpExt greater than
  322.         2.17. I was talking through somewhere I'd rather not specify. All
  323.         that did was fix it so it didn't work with versons less than 2.17.
  324.         Basically, try and lay your hands on a copy of v2.17 or greater. If
  325.         not, write me and I'll give you a copy. Still don't know why it
  326.         doesn't work. Also added nice logo. Well, that's it. I'm in the
  327.         middle of reading the Hitch-Hiker trilogy (5 books, and they STILL
  328.         call it a trilogy?) for the umpteenth time, and I still love them
  329.         all (or do I love the fact that Catriona loves them too?), so I'm
  330.         off to read them. Definetely more intresting than Zool, which gets
  331.         boring after you've completed it squillions of times. (If you can't
  332.         complete it, write me and I'll give you a copy of my Zool Cheatmod
  333.         (or even better (for Andy that is), buy The Hacker (or if Desktop
  334.         Hacker is out, buy that.)))
  335.